==============================================================================
Amazon ODBC Driver for Apache Hive Release Notes
==============================================================================

The release notes provide details of enhancements, features, known issues, and
workflow changes in Amazon ODBC Driver for Apache Hive 2.9.1, as well as the 
version history.

This version of the driver supports the following data source versions and 
platforms:

 * Apache Hive 1.0 to 3.1.3

 * Windows 11; Windows Server 2016, 2019, 2022, 2025
 * macOS 12, 13, 14, 15 (Universal Binary with Intel and ARM support)
 * RHEL 8, 9, 10; RHEL 8, 9, 10 (ARM); SLES 15; Amazon Linux 2023 (ARM)


2.9.1 ========================================================================

Released 2026-02-20

Enhancements & New Features

 * [HAR-1459] Added support to ignore tables metadata from all schemas
 
   Added a new configuration to control whether SQLTables API calls that 
   request metadata from all schemas should be ignored and return an empty 
   result set. For more information, see the configuration option "Ignore 
   Tables Metadata From All Schemas" in the Installation and Configuration 
   Guide.
   
 * [HAR-1462] Logging options UI enhancement

   A warning message appears when users without the administrator permissions 
   click Logging Options button. For more information, see the section 
   "Configuring Logging Options in Windows" in the Installation and 
   Configuration Guide.

 * [HAR-1477][HAR-1493][HAR-1503] Updated third-party libraries

   The driver now uses the following third-party libraries:
   - Boost 1.84.0 (previously 1.81.0)
   - Expat 2.7.3 (previously 2.7.1)
   - ICU 74.2 (previously 71.1)
   - libcURL 8.18.0 (previously 8.12.1)
   - lz4 1.10.0 (previously 1.9.4)
   - OpenSSL 3.0.19 (previously 3.0.16)
   - ZooKeeper 3.9.3 (previously 3.7.1)

 * [HAR-1477] Updated platform support

   The driver now supports the following platform versions:
   - Windows Server 2025
   - Red Hat Enterprise Linux (RHEL) 10
   - Red Hat Enterprise Linux (RHEL) 8 ARM, 9 ARM, and 10 ARM
   - macOS 14 (Universal Binary with Intel and ARM support)
   - macOS 15 (Universal Binary with Intel and ARM support)


Resolved Issues
The following issue has been resolved in Amazon ODBC Driver for Apache Hive 
2.9.1.

 * [HAR-1442] The driver does not return result sets for queries that 
   include comments.


Known Issues
The following are known issues that you may encounter due to limitations in 
the data source, the driver, or an application.

 * [HAR-1171] The Hive server does not currently support using scientific 
   notation for FLOAT type.

   As a workaround, to use scientific notation, cast the data to a DECIMAL. 
   For example:

   SELECT CAST(3.33333e-07 AS DECIMAL)

 * On Hive 3.0 and later, when the server does not set the metastore schema 
   reader properly, the driver returns the following error:

   Error from server: error code: '0' error message:
   'MetaException(message:java.lang.UnsupportedOperationException:
   Storage schema reading not supported)'

   To resolve this issue, set the following in the Hive server:
   metastore.storage.schema.reader.impl=
   org.apache.hadoop.hive.metastore.SerDeStorageSchemaReader


Workflow Changes =============================================================

The following changes may disrupt established workflows for the driver.

2.9.1 ------------------------------------------------------------------------

 * [HAR-1477] Removed support for earlier platform versions

   Beginning with this release, the driver no longer supports the following
   platform versions:
   - Windows 10
   - CentOS 7
   - Oracle Linux 7.5 and 7.6
   - SUSE Linux Enterprise Server (SLES) 12
   - macOS 11 (Universal Binary with Intel and ARM support)


2.8.1 ------------------------------------------------------------------------

 * [HAR-1346] Updated SAML SSO cookie cache option

   When using SAML SSO cookie cache with SAML SSO authentication, the username
   and password are now optional for the Windows platform.

 * [HAR-1350] Removed support for macOS universal bitness

   Beginning with this release, the driver no longer supports universal
   bitness for macOS. Support for macOS versions 10.14 and 10.15 have been
   removed.

 * [HAR-1084][HAR-1095][HAR-1392] Removed support for Visual C++ 
   Redistributable for Visual Studio 2013 and 2015

   Beginning with this release, the driver no longer supports Visual C++
   Redistributable for Visual Studio 2013 and 2015. For information about the  
   supported versions, see the Installation and Configuration Guide.
   
 * Removed support for Apache Hive versions earlier than 1.0.0

   Beginning with this release, the driver no longer supports Apache Hive
   versions earlier than 1.0.0.

 * [HAR-1271] Updated HTTPAuthCookies default value

   The default value for HTTPAuthCookies is now hive.server2.auth,JSessionID,
   KNOXSESSIONID,KNOX_BACKEND-HIVE. Previously, the default value for 
   HTTPAuthCookies was hive.server2.auth,JSessionID. For more information, see
   the Installation and Configuration Guide.

 * [HAR-1315] Updated QueryTimeoutOverride default value

   The default value for QueryTimeoutOverride is now an empty string. 
   Previously, the default value for QueryTimeoutOverride was Zero. For more
   information, see the Installation and Configuration Guide.

 * [HAR-1316] Updated SSOIgnoreDriverNoPrompt default value

   The default value for SSOIgnoreDriverNoPrompt is now true. Previously, the 
   default value for SSOIgnoreDriverNoPrompt was false. For more information,
   see the Installation and Configuration Guide.

 * [HAR-1061][HAR-1086][HAR-1088][HAR-1082][HAR-1087][HAR-1089][HAR-1224] 
   [HAR-1229][HAR-1230][HAR-1231][HAR-1400] Removed support for OS platforms

   Beginning with this release, the driver no longer supports the following
   OS platforms:
   - Windows 7 and 8.1
   - Windows Server 2008, 2008r2, and 2012
   - macOS 10.13 and 10.14
   - Red Hat Enterprise Linux (RHEL) 7
   - SUSE Linux Enterprise Server (SLES) 11


2.6.1 ------------------------------------------------------------------------

 * Minimum TLS Version

   Beginning with this release, the driver requires a minimum version of TLS 
   for encrypting the data store connection. By default, the driver requires 
   TLS version 1.2. This requirement may cause existing DSNs and connection 
   strings to stop working, if they are used to connect to data stores that 
   use a TLS version earlier than 1.2.

   To resolve this, in your DSN or connection string, set the Minimum TLS 
   option (the Min_TLS property) to the appropriate version of TLS for your 
   server. For more information, see the Installation and Configuration Guide.


Version History ==============================================================

2.8.3 ------------------------------------------------------------------------

Released 2025-08-15

Enhancements & New Features

 * [HAR-1425] Upgraded third-party libraries

   The driver now uses the following third-party libraries:
   - Expat 2.7.1 (previously 2.6.3)
   - libcurl 8.12.1 (previously 8.10.1)
   - OpenSSL 3.0.16 (previously 3.0.15)

 * [HAR-1428] Updated platform support

   The driver now supports the Amazon Linux 2023 (ARM) platform version.


Resolved Issues
The following issue has been resolved in Amazon ODBC Driver for Apache Hive 
2.8.3.

 * [HAR-1425] The HTTP User-Agent header's thrift version is now updated from 
   0.9.0 to 0.17.0.


2.8.1 ------------------------------------------------------------------------

Released 2024-11-29

Enhancements & New Features

 * [HAR-1184][HAR-1294][HAR-1311][HAR-1344][HAR-1349][HAR-1351][HAR-1392]
   [HAR-1412][HAR-1413][HAR-1414][HAR-1415] Upgraded third party libraries

   The driver now uses the following third-party libraries:
   - Apache Thrift 0.17.0 (previously 0.9.0)
   - Apache ZooKeeper 3.7.1 (previously 3.4.6)
   - Boost 1.81.0 (previously 1.64.0)
   - cyrus sasl 2.1.28 (previously 2.1.26)
   - Expat 2.6.3 (previously 2.4.6)
   - ICU 71.1 (previously 58.2)
   - lz4 1.9.4 (previously 1.9.3)
   - libcurl 8.10.1 (previously 7.84.0)
   - OpenSSL 3.0.15 (previously 1.1.1d)
   - RapidJSON custom version addressing CVE-2024-39684. (previously 1.1.0)
   - Zlib 1.3.1 (previously 1.2.11)

 * [HAR-1314] SAML SSO cookie cache support

   You can now avoid invoking multiple browser prompts when connecting with
   SAML SSO authentication to create multiple connections within the same 
   application using the same DSN or connection string. To do this, select the
   Enable Auth Cookie Caching checkbox (set the EnableSamlCookieCaching 
   property to 1). For more information, see the Installation and 
   Configuration Guide.

 * [HAR-730] Updated MapR SASL authentication

   You can now authenticate your driver using MapR SASL. To do this, set 
   the Mechanism option to MapR SASL (or set the AuthMech property to 13). For 
   more information, see the Installation and Configuration Guide.

 * [HAR-1288] New mechanism for SAML SSO

   The driver now includes a mechanism to close the browser automatically 
   upon successful authentication via SAML SSO.

   Note that the browser tab for the authentication session of the first 
   connection that requires the user to enter the credentials does not 
   automatically close. The browser tab for all subsequent connection
   attempts that do not require the user to enter the credentials will close 
   automatically.

 * [HAR-1289] Override SQL_ATTR_QUERY_TIMEOUT

   You can now configure the driver to override SQL_ATTR_QUERY_TIMEOUT. To 
   do this, set the QueryTimeoutOverride property to the desired amount of 
   time in seconds. For more information, see the Installation and 
   Configuration Guide.

 * [HAR-1302] Heartbeat messages

   The driver now attempts to send heartbeat messages to the server while 
   fetching query results to keep the query operation active.
 
 * [HAR-1303] Configure query translation for CTAS syntax

   You can now configure the driver to perform a query translation for the
   CTAS syntax. To do this, select the Enable Translation For CTAS check box 
   (set the EnableTranslationForCTAS property to 1). For more information, see 
   the Installation and Configuration Guide.

 * [HAR-1305] Configuring the DSN file

   On Windows, the driver can now read configuration names from the DSN 
   file. To do this, set the ConfigsFromFileDSN property to a comma-separated
   list of configuration names. For more information, see the Installation and
   Configuration Guide.

 * [HAR-1191] SSO authentication

   You can now authenticate using single sign-on (SSO) via SAML 2.0 on
   supported servers. For more information, see the Installation and
   Configuration Guide.

 * Updated documentation

   Information on connecting through a proxy server is now documented in the
   Installation and Configuration Guide. For more details, see the 
   Installation and Configuration Guide.

 * [HAR-1180] Updated logging configurations

   You can now configure logging for the current connection by setting the
   logging configuration properties in the DSN or in a connection string. For
   more information, see the Installation and Configuration Guide.

 * [HAR-1185] Updated DSN password configuration

   On Windows, when configuring an existing or creating a new system DSN, the 
   driver no longer saves the encrypted version of any password 
   configuration value (PWD, ProxyPWD, ClientPrivateKeyPWD, etc.) by default.

   To save the encrypted version of any password configuration value, you must
   now explicitly select a password encryption option for the corresponding
   password configuration.

 * [HAR-1272] Updated Hive server version support

   The driver now supports Apache Hive server versions 1.0 through 3.1.3.

 * [HAR-1343] Updated BDS support

   For BDS specific server-side properties, adding the SSP_prefix is no longer
   required. The driver also does not convert the BDS specific server-side
   property key names to lower case characters.

 * [HAR-1350] Updated macOS support

   On macOS, the driver is now a Universal driver that natively supports 
   Apple Silicon. For security best practices, it is suggested to keep both
   the driver and OS updated.

 * [HAR-1225][HAR-1227][HAR-1228][HAR-1400] Updated platform support

   The driver now supports the following platform versions:
   - Windows 11
   - Windows Server 2022
   - macOS 11, 12 and 13 (Universal Binary with Intel and ARM support)
   - Red Hat Enterprise Linux (RHEL) 8 and 9
   - SUSE Linux Enterprise Server (SLES) 15

 * [HAR-1392] Upgraded Visual Studio support

   The driver now uses Windows Visual Studio 2022.

 * [HAR-1392] Security updates

   The driver has been updated with security improvements.

 * [HAR-1392] Updated security flags

   The following security flags have been used to improve security
   checks in the driver:  
   - /CETCOMPAT
   - /CFG
   - /Qspectre 
   - /SDL


Resolved Issues
The following issues have been resolved in Amazon ODBC Driver for Apache Hive 
2.8.1.

 * [HAR-1287] The HTTP connection client does not reinitialize after an 
   SSL_read error.

 * [HAR-1300] In some cases, when using Linux, the driver terminates 
   unexpectedly when resolving host names.

 * [HAR-1301] When using UnixODBC on Linux, error messages are truncated.

   The value of ErrMsgMaxLen can now be changed, but this may cause the 
   driver to terminate unexpectedly in some cases. This is due to a 
   limitation of UnixODBC.

 * [HAR-1304] The driver does not allow the use of server and intermediate 
   certificates that do not have a CRL distribution points (CDP) entry.

 * [HAR-1306] When using a proxy, the driver sets the incorrect host name 
   for SSL Server Name Indication (SNI).

 * [HAR-1308] In some cases, when using an HTTP, SSL, and proxy connection, 
   the driver returns an "SSL_connect: wrong version number" error.

 * [HAR-1220] When using a new TCP connection to make a HTTP request, the
   driver does not honor cookies.

 * [HAR-1214] When reconnecting to a Kerberized cluster using ZooKeeper, the
   driver does not connect.

 * [HAR-1157] In some cases, on Linux and macOS, when checking licenses, the
   driver terminates unexpectedly.

 * [HAR-1323] The REMARKS column of the tables metadata does not populate with
   comments.

 * [HAR-1335] In some cases, when handling primary keys and foreign keys 
   catalog functions, the driver terminates unexpectedly.

 * [HAR-1325][HAR-1330] When executing a query with CREATE TABLE AS SELECT,
   the driver refers to a schema as an invalid table and returns an error.

 * [HAR-1337] When in ZooKeeper discovery mode and a network error occurs, the
   driver does not connect to the same HS2 instance on a reconnecting 
   attempt.


==============================================================================
Contact Us
==============================================================================

For support, check the EMR Forum at 
https://forums.aws.amazon.com/forum.jspa?forumID=52 or open a support case 
using the AWS Support Center at https://aws.amazon.com/support 
